home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 001a / pns50.zip / COMMOPNS.DOC next >
Text File  |  1991-09-01  |  9KB  |  268 lines
  1.  
  2.                                COMMOPNS 5.0
  3.  
  4.                               August 30, 1991
  5.  
  6.                                 Shad Muegge
  7.                               Marcos R. Della
  8.  
  9.                                  ____
  10.                        -------|\/ o  \------------------
  11.                           ____|    ,__| Association of
  12.                          /  o \/|____/  Babble Fish
  13.                         |__,    |____   Programmers
  14.                          \____|\/ o  \
  15.                               |    ,__| MEMBER
  16.                        -------|/\____/------------------
  17.  
  18.        COMMOPNS is shareware, which means that you can use this program
  19.        for 30 days to decide whether you want to use it.  If you decide
  20.        you are going to use COMMOPNS, you must send in the registration fee.
  21.  
  22.        Send your COMMOPNS registration fee of $10.00 US to:
  23.  
  24.             Shad Muegge
  25.             P.O. BOX 4251
  26.             Santa Rosa, CA  95402
  27.  
  28.        This is a LIFETIME registration fee, meaning that you will never
  29.        have to pay for any future versions of COMMOPNS.
  30.  
  31.        COMMOPNS may be freely distributed in its original PKZIPed form.
  32.  
  33.        SUPPORT:  You can either send me a letter, to which I will gladly
  34.        respond, or you can call my BBS: The Babble Underground (707) 575-0636.
  35.  
  36.        Thanks to:
  37.           Fred P. Brucker for writing {COMMO}.
  38.           Tom Keller, for editing this file.
  39.           And everyone else who Beta Tested COMMOPNS.
  40.  
  41. BASIC CONCEPT:
  42.  
  43.       COMMOPNS.EXE - Displays a single directory at a time and
  44.         allows the user to TAG files.  When the program is exited,
  45.         it writes the TAGGED files out to a specified (or default)
  46.         file.
  47.  
  48. OPERATION:
  49.  
  50.     An up arrow in front of a name indicates a subdirectory which will
  51.     lead you up the directory tree.  Likewise, a down arrow indicates
  52.     a subdirectory which will lead you down the tree.
  53.  
  54.     COMMANDS:
  55.        <ENTER> Change to a SUBDIR.
  56.  
  57.       <ARROWS> Moves selector bar around.
  58.  
  59.  <PGUP> <PGDN> Switches file display pages.  Useful if your directory
  60.                has more than 115 files in it!
  61.  
  62.   <HOME> <END> Move to the first/last item on the screen.
  63.  
  64.        <SPACE> Toggle the tag flag, and advance to next file in the display.
  65.                Also updates approximate upload time estimate, if the -S
  66.                option was specified on the command line.
  67.  
  68.      <Any Key> Advance selector bar to filename starting with that key.
  69.                For example: Press M to jump to filenames starting with M.
  70.  
  71.           <F1> Bring up a small help list.
  72.  
  73.        <ALT-D> Change the drive.
  74.  
  75.          <ESC> Exit and write tag file list.
  76.  
  77.  <ALT - F1/F2> Change colors for foreground/background main screen.
  78.  <ALT - F3/F4> Change colors for foreground/background highligh bar.
  79.  <ALT - F5/F6> Change colors for foreground/background status lines.
  80.  
  81.        <ALT-C> Save colors and display method (BIOS/Direct).
  82.  
  83.        <ALT-U> Toggle between BIOS and Direct screen writes.
  84.  
  85. BASIC IMPLEMENTATION:
  86.  
  87.         DSZ, MPt, and others allow a list of files to be specified
  88.         in a file.  For example:
  89.                     DSZ sz @C:\FILE.LST
  90.                     MPt s @C:\FILE.LIST
  91.  
  92.          will upload all the files in C:\FILE.LST.
  93.  
  94.          In DSZ, the @, the drive letter and the : are all MANDATORY.
  95.  
  96.                                 PAGE 1
  97.  
  98.       Getting COMMOPNS to work with your terminal program, should be
  99.          simple, here's a example in a psuedo-terminal program
  100.          script language:
  101.  
  102.          Execute COMMONPNS C:\FILE.LST
  103.          Execute DSZ sz @C:\FILE.LST    { for ZMODEM  }
  104.       or Execute MPt s @C:\FILE.LST     { for MPt }
  105.          Execute DEL C:\FILE.LST        { this is optional }
  106.  
  107.  
  108. SETUP FOR {COMMO}:
  109.  
  110.       1. Put COMMOPNS.EXE somewhere in your path.
  111.  
  112.       2. Insert the COMMOPNS.MAC file into your COMMO.MAC
  113.          file - using your favorite ASCII text editor.
  114.  
  115.       3. Load {COMMO}.
  116.  
  117.       4. Type <Ctrl-PageUp> to get COMMOPNS Upload Menu!
  118.  
  119.       5. UPLOAD UPLOAD UPLOAD
  120.  
  121. AUTOMATIC COMMOPNS in {COMMO} with ZMODEM!
  122.  
  123.       In COMMO.SET file, insert the line:
  124.         {aut=pnszup,^xB01}
  125.       Now, whenever you do a Zmodem upload, COMMOPNS will automatically execute.
  126.  
  127. SETUP IN A BATCH FILE:
  128.  
  129.    For Upload: Some terminal programs allow you to call external
  130.                batches for their file transfer protocols.
  131.  
  132.       Example Batch File: (Zmodem or MPt Upload)
  133.  
  134.       @ECHO OFF
  135.       COMMOPNS C:\FILE.LST
  136.       DSZ sz @C:\FILE.LST
  137.    or MPt s @C:\FILE.LST
  138.  
  139. USE WITH PKZIP:
  140.  
  141.     This will allow you to pick files out of single or multiple
  142.     directories and zip them together.  Note that additional command
  143.     line parameters can be added to the PKZIP line to preserve paths, etc.
  144.  
  145.    PNSZIP.BAT:
  146.       @ECHO OFF
  147.       COMMOPNS C:\FILE.LST
  148.       PKZIP -a %1 @C:\FILE.LST
  149.  
  150.    Example command line:
  151.         PNSZIP PNSSRC.ZIP
  152.  
  153.                                  PAGE 2
  154.  
  155. PARAMETER DEFINITIONS:
  156.  
  157.    - if no parameters are specified, then the file list is CREATED
  158.      in the DEFAULT drive ROOT directory.
  159.       (i.e. if COMMOPNS is run on C:, the file would be C:\FILE.LST)
  160.  
  161.    COMMOPNS [DRIVE:][PATH][FILEN] [-F] [-O<N|T|E>] [-D[DRIVE:][PATH]] [-S<bps>]
  162.  
  163.          DRIVE: The drive where you want the file.
  164.                         (ie. C:, D:, ... )
  165.          PATH: The path where you want to file.
  166.                         (ie. \COMMO\)
  167.          FILEN: The file name, you want the list to be written.
  168.  
  169.          An Error Level 2 is returned for invalid tag list filename.
  170.  
  171.          -F: Fast video, the program will write directly to the
  172.              screen instead of going through the BIOS. Don't use this
  173.              option if you get lots of snow, or if you are using
  174.              multi-tasking software ( e.g.;Desqview, DoubleDos).
  175.              This is the same as -F1.
  176.  
  177.         -F0: Forces BIOS screen writes. (Default)
  178.         -F1: Forces direct screen writes.  Saving the configuration
  179.              with the <ALT-C> after entering COMMOPNS with this switch
  180.              will make it the default.
  181.  
  182.          -D: Optional directory in which to begin tagging.  The drive
  183.              specifier is only necessary if you wish to start up on a
  184.              drive other than the current drive.
  185.  
  186.          -S: Modem transfer speed, in Bits Per Second.  If this option is
  187.              specified, COMMOPNS will compute and display the approximate
  188.              time needed to transfer the tagged files.
  189.  
  190.         -ON: Sort in order of filename. (Default)
  191.         -OT: Sort in order of date & time.
  192.         -OE: Sort in order of extension.
  193.  
  194. ENVIRONMENT VARIABLE:
  195.  
  196.         Setting a COMMOPNS environment variable in DOS will tell COMMOPNS
  197.         where to write the list of TAGGED files.
  198.  
  199.         For Example: SET COMMOPNS=C:\FILES.LST
  200.  
  201.         This will cause COMMOPNS to write the file list to C:\FILES.LST
  202.  
  203.         Specifing a name on the command line will override this environment
  204.         variable.
  205.  
  206.  
  207.  
  208.  
  209.  
  210.                                 PAGE 3
  211.  
  212. REVISION HISTORY:
  213.   Version            New Stuff/Fixes.
  214.  
  215.     5.0   Major re-write of the basic code to increase speed.
  216.           COMMOPNS enviroment variable added so you can specify the
  217.             file to be created by the program.
  218.           ErrorLevel 1 returned if there is an empty file list.
  219.           Direct Video writes re-written in assembly to increase display
  220.             speed to the screen.  BIOS calls still in place for DV users.
  221.           Alt-U added to toggle between BIOS and Direct Video writes.  This
  222.             parameter can be saved using the Alt-C (clone) option.
  223.           F1 now brings up a help screen with the basic commands.
  224.           Pressing a key to jump to a file
  225.           Error level 2 returned for invalid tag file list filename.
  226.  
  227.     #.#   These versions skipped in a cheap marketing attempt to cash in
  228.           on the version 5.0 mania.
  229.  
  230.     2.1   Bug fixes.
  231.  
  232.     2.0   Added color and ability to change colors.
  233.       -D start directory option.
  234.           -S Bits Per Second option, so COMMOPNS can display upload time.
  235.       Arrows for indicating directories.
  236.           Checks memory available, instead of crashing.
  237.  
  238.     1.5   Fixed up a bunch of stuff in the doc files.
  239.       Added the current directory display to the top of the screen.
  240.           Add BIOS/Direct screen writing for snowy CRT's and multi-taskers.
  241.           Advance to next file after tagging a file.
  242.  
  243.     1.1   Modified to use a lot less memory.
  244.  
  245. BUGS: (bugz), adj. [Slang], 1. crazy; insane. 2. any crawling insect
  246.  with sucking mouth parts and forewings thickened. 3. Problems with a
  247.  computer program.  (go figure!)
  248.  
  249.  - The program doesn't seem to work on the novell network. When it
  250.    reads in the directory, it doesn't find a ".." parent directory
  251.    file.
  252.  
  253. DETAILS:
  254.    {COMMO} is a product of Fred P. Brucker.
  255.    DSZ is a product of Omen Technology Inc.
  256.    PKZIP is a product of PKWARE, INC.
  257.    MPt is a product of Matthew Thomas.
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.                                 PAGE 4
  267.  
  268.